package cn.tedu.csmall.product.repo;

import cn.tedu.csmall.product.pojo.vo.BrandListItemVO;
import cn.tedu.csmall.product.pojo.vo.BrandStandardVO;

import java.util.List;

/**
 * 处理品牌缓存的数据访问接口
 *
 * @author Chen
 * @since 2023/2/13 11:27:27
 */
public interface BrandRedisRepository {

    /**
     * 品牌数据在缓存中的key的前缀
     */
    String BRAND_ITEM_PREFIX = "brand:item:";
    /**
     * 品牌列表数据在缓存中的key
     */
    String BRAND_LIST_KEY = "brand:list";
    /**
     * 品牌数据的所有缓存数据的Key的集合的Key
     */
    String BRAND_ALL_KEYS_KEY = "brand:all-keys";

    /**
     * 向缓存中存入品牌数据
     *
     * @param brandStandardVO 品牌数据
     */
    void save(BrandStandardVO brandStandardVO);

    /**
     * 向缓存中存入品牌数据列表
     *
     * @param brandList 品牌数据列表
     */
    void save(List<BrandListItemVO> brandList);

    /**
     * 删除品牌中所有缓存数据
     */
    void deleteAll();

    /**
     * 从缓存中读取品牌数据
     *
     * @param id 品牌id
     * @return 匹配的品牌数据，如果没有匹配的数据，则返回null
     */
    BrandStandardVO get(Long id);

    /**
     * 从缓存中读取全部品牌的列表数据
     *
     * @return 全部品牌的列表数据
     */
    List<BrandListItemVO> list();

    /**
     * 从缓存中读取品牌的列表数据
     *
     * @param start 读取数据的起始下标，下标值从0开始顺序编号
     * @param end   读取数据的截止下标，如果需要读取至最后一条数据，请使用 -1
     * @return 品牌列表数据
     */
    List<BrandListItemVO> list(long start, long end);

}
